home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / pnpcb250.zip / PNEWSPCB.DOC next >
Text File  |  1991-01-02  |  12KB  |  220 lines
  1.     -----------------------------------------------------------------------
  2.        The documentation is Copyright 1991, Cory Wright, TRC Development
  3.     -----------------------------------------------------------------------
  4.  
  5.     ██████                                  ██   ██
  6.      ██  ██                                 ███  ██
  7.      ██  ██  █████  ██   ██  █████  ██ ████ ████ ██  █████  ██   ██  █████
  8.      █████  ██   ██ ██   ██ ██   ██  ███ ██ ██ ████ ██   ██ ██   ██ ██
  9.      ██     ██   ██ ██ █ ██ ███████  ██     ██  ███ ███████ ██ █ ██  █████
  10.      ██     ██   ██ ███████ ██       ██     ██   ██ ██      ███████      ██
  11.     ████     █████  ██   ██  █████   ██     ██   ██  █████  ██   ██  █████
  12.  
  13.     -----------------------------------------------------------------------
  14.     PowerNews/PCB v2.50    Cory Wright, TRC Development     January 2, 1991
  15.     -----------------------------------------------------------------------
  16.  
  17.     Abstract
  18.     --------
  19.     PowerNews allows  sysops to create, modify,  and maintain multiple sets
  20.     of  news bulletins.  The sysop  has full  control over  colors and text
  21.     layout. PowerNews sports a full-fledged text editor with mouse support,
  22.     preview  before  saving,  reverse  chronological  news  entry, built-in
  23.     viewer,  importation  of  text  files  into  bulletins, colorization of
  24.     standard  ASCII  text   files  for  use  either  on   the  BBS  or  for
  25.     correspondence,  editing  of  existing  news  screens,  and deletion of
  26.     individual news screens within a single news files, and much more.
  27.  
  28.     ∙ PowerNews/PCB allows creation and maintenance of the security specific
  29.       logon news screens along with the NEWS and NEWSG files for the main
  30.       board and up to 1024 other conferences.
  31.  
  32.     ∙ PowerNews/PCB is flexible enough to create any other ASCII and ANSI
  33.       file that you may need to create.
  34.  
  35.     ∙ PowerNews/PCB allows the colorization of any ASCII text file.
  36.  
  37.     ∙ PowerNews/PCB allows the importation of text into a news screen
  38.  
  39.  
  40.     News files
  41.     ----------
  42.     PowerNews creates and  maintains both the ASCII (normal  file name) and
  43.     ANSI ('G'  appended to filename)  news files; therefore,  when bulletin
  44.     files  without extensions  are mentioned  throughout the  document, you
  45.     should assume that it concerns both the ASCII and ANSI files.
  46.  
  47.     The NEWS and  NEWSG files (ASCII/ANSI) are shown to  every user as they
  48.     log on. Therefore, use them to announce system-wide information that is
  49.     pertinent to every  user on the BBS. I use  it to announce the addition
  50.     of  new  doors,  new  conferences,  and  other  things  like  a  script
  51.     questionnaire that needs to be filled out.
  52.  
  53.     The Security Specific  announcement files are quite useful  if you know
  54.     how  to implement  them. Simply  use the  Security Specific option when
  55.     choosing the  news screen you wish  to create. You will  be asked for a
  56.     security level.  Just enter the  number, and type  in the news!  In the
  57.     future, any user with that security level will see the news you've sent
  58.     to his specific security level.
  59.  
  60.     One example of a practical use of this feature is when you wish to keep
  61.     your beta testers informed of updates. I have beta testers that call my
  62.     system. Since beta software is  constantly changing, you could give the
  63.     testers an  access level of  70 in PCBoard.  Then use PowerNews/PCB  to
  64.     write news  to them with  security 70 as  outlined above. You  can keep
  65.     certain groups of  people informed in an efficient  manner with the use
  66.     of this feature.
  67.  
  68.  
  69.     Using PowerNews
  70.     ---------------
  71.     All  options are  self-explanatory. You  may access  help from the main
  72.     menu by pressing F1. The following is a description of each function:
  73.  
  74.     Key  Description        Extended information
  75.     ---  -----------------  -----------------------------------------------
  76.     [A]  Add a news screen  Appends an individual news screen to your choice
  77.                             of files.  From this selection, you may type
  78.                             freely, or import text to edit in your bulletin.
  79.     [E]  Edit a news file   Loads your editor to edit the ASCII version
  80.                             of the entire news file you choose.  Upon
  81.                             exiting, your ANSI news file is reconstructed.
  82.     [D]  Delete a news      Lists headings of all news screens in the file
  83.          screen             you choose.  You may relist the headings, view
  84.                             individual bulletins, delete specific screens,
  85.                             or delete all screens in the file.
  86.     [T]  Reconstruct ANSI   Reconstructs an ANSI version of the news file
  87.          news file          you choose.  The ASCII version of the file must
  88.                             be in the PowerNews format.  Use the [C]olorize
  89.                             option to colorize unformatted files.
  90.     [V]  View a news file   Allows viewing of an entire news file via the
  91.                             built-in viewer.  Use the cursor keys to move
  92.                             about the news file.
  93.     [C]  Colorize a file    Constructs a colorized file, not in PowerNews
  94.                             format for use in a bulletin or elsewhere.
  95.  
  96.     Choosing  any of  the upper  commands will  cause a  selection menu  to
  97.     appear. Three choices are possible at the selection menu.
  98.  
  99.      ∙  F1 - will allow you to manipulate the main NEWS/NEWSG files.
  100.      ∙  F2 - will allow you to manipulate conference NEWS/NEWSG files.
  101.      ∙  F3 - allows entry of security specific news files.
  102.      ∙ F10 - will allow you to type your own file name in to work with.
  103.      ∙ ESC - sends you back to the main menu
  104.  
  105.     Everything is self explanatory within the  program, but if you have any
  106.     questions, feel  free to write  me at  the  address at the  end of this
  107.     document.
  108.  
  109.  
  110.     Guidelines for use
  111.     ------------------
  112.     PowerNews/PCB should be run from your PCBoard directory. The first time
  113.     you run  PowerNews/PCB, you will be  told that the program  cannot find
  114.     the PNEWSPCB.CNF  file. You should  answer (C) to  continue running the
  115.     program. If this  message appears in the future, make  sure you ran the
  116.     program from your PCBoard directory. If you didn't, then choose (A)bort
  117.     and change to the correct directory. You  may wish to make a batch file
  118.     called PNEWS.BAT  (or just NEWS.BAT)  and place the  following lines in
  119.     it:
  120.  
  121.        e:
  122.        cd\pcb
  123.        pnewspcb
  124.  
  125.     This way, you  can be positive that you were  in your PCBoard directory
  126.     (in this case, E:\PCB) when running  the program. Make sure you have at
  127.     least  256k free  when  running  PowerNews/PCB. Memory  required varies
  128.     depending  on  the  number  of   conferences  you  have  on  your  BBS.
  129.     PowerNews/PCB only  supports 1024 conferences  at this time.  I will be
  130.     more  than happy  to compile  a special  version that  will handle more
  131.     conferences if necessity dictates.
  132.  
  133.  
  134.     Registration
  135.     ------------
  136.     If  you  use  PowerNews/PCB!  for  over  30  days,  you are required to
  137.     register the software.  Registration has been made easy  with the built
  138.     in registration  form. After the  introduction screen, press  <R> to go
  139.     into registration  mode. Enter your  name, address and  other pertinent
  140.     information, then let your printer do the work!
  141.  
  142.  
  143.     Standard Demo License
  144.     ---------------------
  145.     PowerNews is a Shareware program, and  uploading of the code to various
  146.     bulletin  boards and  Shareware libraries  is encouraged;  however, the
  147.     following limitations are imposed:
  148.  
  149.     1) Under no circumstances should the code be modified or distributed in
  150.     any other form than what it  was originally supplied by the author. The
  151.     exception is  that PowerNews may  be compressed using  techniques other
  152.     than ZIP, but the de-compressed form of PowerNews must remain intact.
  153.  
  154.     2)  PowerNews  may  not  be  redistributed  in  any  manner  other than
  155.     electronic file transfer unless cleared  with the author beforehand. No
  156.     money   may   be   received   for   PowerNews   except   to  cover  for
  157.     telecommunications / service  charges, and in such a  case the cost may
  158.     not exceed $5.00 US.
  159.  
  160.     3) PowerNews may be run for 30 days, an adequate time to allow for full
  161.     testing of  the software. If, after  running the code for  30 days, you
  162.     decide not  to purchase the  registration license and  number, you must
  163.     forfeit  this  license  and  remove  PowerNews  from  operation on your
  164.     system(s). You may keep a copy online for distribution purposes only.
  165.  
  166.     4) PowerNews may not be hacked or modified in ANY manner, including but
  167.     not limited  to modifications leading  to the use  of features intended
  168.     for registered users only. These features are listed in the program and
  169.     may be listed under "Limitations" in this document.
  170.  
  171.     5)  The   registration  license  is   non-transferable  and  under   no
  172.     circumstance may the registration number  of another individual be used
  173.     to enable these features or to meet any other purpose.
  174.  
  175.  
  176.     Registration License
  177.     --------------------
  178.     1) Once purchasing the registration license, limitations are lifted and
  179.     the license is extended for life. All future releases of PowerNews will
  180.     be made available,  registered, for no additional charge.  In any event
  181.     that PowerNews does  not work properly, the author,  Cory Wright, shall
  182.     be  liable for  no more  than $10.00  US, and  then only  if an  honest
  183.     attempt  was made  to contact   the author  and the  situation remained
  184.     unresolved.
  185.  
  186.     2) Registering  PowerNews entitles the registering  party access to The
  187.     Rising Connection BBS or whatever  location support is maintained. This
  188.     privilege is guaranteed  for as long as the  program is being developed
  189.     and supported. Access may be terminated  if any rules or regulations of
  190.     the bulletin board are broken by the registering party.
  191.  
  192.     3)  The registration  license is  non-refundable and  non- transferable
  193.     without  prior consent  of the  author, Cory  Wright. The  name of  the
  194.     bulletin board  may be changed if  evidence is given that  the board is
  195.     truly changing names and in such a case the old registration number may
  196.     not  be used  under any  circumstances. A  processing fee  may apply to
  197.     change a BBS Name.
  198.  
  199.  
  200.     Disclaimer
  201.     ----------
  202.     The author, Cory Wright, takes  no responsibility nor liability for any
  203.     data loss, incurred  costs, or equipment damage resulting  from the use
  204.     of PowerNews,  unless evidence can be  given to show that  the code was
  205.     written  to  do  so  intentionally,  at  which  point, the author, Cory
  206.     Wright, will be liable for no more than $10.00 US.
  207.  
  208.     A support BBS is provided for PowerNews/PCB:  The Rising Connection
  209.                                                   615-531-8789
  210.                                                   HAYES ULTRA 9600 V.32
  211.  
  212.     Thanks  again  for  trying  PowerNews/PCB!.  I  hope  that I've done an
  213.     exemplary job on the program. I welcome all comments and suggestions!
  214.  
  215.     Mail all comments, questions, and registrations to:
  216.  
  217.     Cory Wright
  218.     P. O. Box 53041
  219.     Knoxville, Tennessee 37950-3041
  220.